home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 49 / Amiga Format CD49 (2000-01-17)(Future Publishing)(GB)(Track 1 of 3)[!][issue 2000-02].iso / -serious- / misc / poolmem / poolmem.readme < prev    next >
Text File  |  1999-11-30  |  8KB  |  202 lines
  1. Short:    Memory defragmentizer/AllocP superset
  2. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@math.tu-berlin.de (Thomas Richter)
  4. Type:     util/sys
  5. Version:  1.51
  6. Requires: OS 3.0
  7.  
  8. ______________________________________________________________________________
  9.  
  10. If you want to run PoolMem in conjunction with the ppc.library, you must
  11.  
  12. a) launch the ppc.library in front of PoolMem, and
  13. b) specify the "NOMERGE" option.
  14.  
  15. ______________________________________________________________________________
  16.  
  17. IMPORTANT NOTE: In case you encounter stability programs, you'd better check
  18. your installation for broken programs. The algorithms used by PoolMem have
  19. been shown to be stable since a long time (they're working fine here for 
  20. five years now). Truely, I can't promise that this software is 100% bug-free,
  21. but I try my very best. However, up to now, most problems I know of have been
  22. shown to be related to software bugs of other programs. Prominent examples
  23. are some releases of Photogenics, of XiPaint and, that's the latest, some
  24. popular xpk-compressors. A workaround for this bug is now included in the
  25. 5.2 xpkmaster.library, so you'd better update! The current PM release includes
  26. quite a lot of consistency checks and work-arounds for software bugs already,
  27. more than the exec functions ever had. Even more have been added to the 1.48
  28. edition. Even though bugs happen, and no one, including me, is immune against 
  29. bugs, please do not blame PoolMem too quickly for problems it really isn't 
  30. responsible for. Instead, please check your installation, or fill out the
  31. bug form in this archive in case you think something's wrong with this 
  32. program. Starting with release 1.49, PoolMem will refuse to install if any
  33. other patches are installed when it is run. This rule has been true since 
  34. ever, but it seems that nobody read the docs... ...again. 
  35.  
  36. Note that you may install AllocMem type patches ON TOP of PoolMem, but not the
  37. other way round. PoolMem will warn you about this situation.
  38.  
  39. For compatibility: Please READ the documentation. 
  40.  
  41.  
  42. Here's a list of problematic programs:
  43.  
  44. RexxPlus ARexx compiler, and RexxPlus compiled programs:    
  45.     Workaround included, set FREEMEMRESULT to -2.
  46.  
  47. rexxserdev.library:
  48.     Fix in the archive included.
  49.  
  50. amiboot:
  51.     Fixed in later releases of the same program.
  52.  
  53. The Final Odyssey:
  54.     Memory allocation bugged. No fix available.
  55.  
  56. Some xpk-compressors:
  57.     Work-around active since Xpkmaster.library >5.2
  58.  
  59. Photogenics, 1.xxx releases:
  60.     Trashes memory. Simple, but inefficient workaround in the archive.
  61.  
  62. XiPaint:
  63.     Mouse driver bugged. No workaround included.
  64.  
  65. PixMate:
  66.     Memory allocation bugged, workaround in PoolMem included.
  67.  
  68. FFS, releases 43.19 and below:
  69.     ACTION_CLOSE bugged, result code broken. Workaround included.
  70.  
  71. ******************************************************************************
  72. Furthermore, some system handlers have been shown to be too low on stack,
  73. this might cause problems! 
  74.  
  75. The new PatchRAM in this archive will fix this for the RAM disk, and YOU
  76. SHOULD fix this for the FFS and the boot partitions. The minimum recommended
  77. stack size is 786 bytes, DO NOT GO BELOW. IT MIGHT WORK, but this is asking
  78. for trouble.
  79. ******************************************************************************
  80.  
  81. ______________________________________________________________________________
  82.  
  83. IMPORTANT NOTE:    This is now a real¹ PoolMem release, 1.49. Someone uploaded
  84. a bogus 1.45 release with a trojan to the Aminet. Please replace any 1.45
  85. release by this 1.49. There never WAS an official 1.45 release.
  86.  
  87. ¹) Hoping that nobody uploads now a trojan of the 1.49. You can always cross
  88. check releases of my software by looking at my home page, or downloading my
  89. software from there in first place. My web page is *much* safer:
  90.  
  91.     http://www.tu-berlin.de/~thor/thor/index.html
  92.  
  93. In case you see a newer release on the Aminet and this release does not show
  94. up on my home page in a couple of days, you should get suspicious.
  95. ______________________________________________________________________________
  96.  
  97.             Version History
  98.  
  99. This is not the complete version history, check the PoolMem.guide for details.
  100.  
  101. ______________________________________________________________________________
  102.  
  103. 1.51:
  104.  
  105. Some internal cosmetical changes, updated the guide a bit and included a new
  106. release of ShowMem.
  107.  
  108. ______________________________________________________________________________
  109.  
  110. 1.50.1:
  111.  
  112. Copied the guide on top of the binary, which was therefore not included.
  113. No other changes.
  114.  
  115. ______________________________________________________________________________
  116.  
  117. 1.50:
  118.  
  119. The patch check was a bit over-critical in the sense that it checked explicit-
  120. ly whether the library entries where in ROM which is false on machines with
  121. a (MMU-less) RAM remapped ROM. I'm now checking, alternatively, whether the
  122. entries go to the exec segment list which should avoid the problem.
  123. ______________________________________________________________________________
  124.  
  125. 1.49:
  126.  
  127. Added a check for patches installed in front of PoolMem. It will now fail in
  128. case it finds any patches in the memory allocation routines. This rule has
  129. been valid before, but it seems nobody cared about this point.
  130. ______________________________________________________________________________
  131.  
  132. 1.48: (internal release only)
  133.  
  134. Added even more consistency checks on AllocMem and FreeMem. In case you
  135. see the new gurus 0x81000015 or 0x81000016, you'd better contact me, or
  136. check your system for broken programs. Except that, nothing changed.
  137. ______________________________________________________________________________
  138.  
  139. 1.47:
  140.  
  141. The PoolMem memory clear routine is now a bit more effective (slightly).
  142. Allocations with MEMF_REVERSE set will be no longer taken from the memory
  143. scratch list. Added a new option KEEPSORTED that implements a slightly
  144. different scratch management which *might* help to improve the garbage
  145. collection mechanism under certain circumstances. 
  146.  
  147. Note that there's now a bug-report form in case you encounter problems.
  148. ______________________________________________________________________________
  149.  
  150. 1.46:
  151.  
  152. Made sure that the PoolMem allocated memory headers are always in public
  153. memory. NOTE THAT THERE IS NO 1.45 RELEASE. SOMEONE WITH A STRANGE SENSE OF
  154. HUMOUR UPLOADED A TROJAN WITH A FAKED 1.45 RELEASE. DELETE IT IMMEDIATELY AS
  155. SOON AS YOU SEE IT AND REPLACE IT BY THIS 1.46.
  156. Updated ShowMem as well.
  157.  
  158.  
  159. 1.44:
  160.  
  161. Fixed a minor problem in the allocation function that might have resulted
  162. in non-optimal memory layout on some boards and could have caused slow-downs.
  163.  
  164.  
  165. 1.43.1:
  166.  
  167. Forgot to include the latest release of ShowMem. Oops! Thanks Raphael!
  168. Note that PoolMem *is not* compatible to MuGuardianAngel!
  169.  
  170.  
  171. 1.43:
  172.  
  173. PoolMem does no longer try to pool non-MEMF_PUBLIC memory. This might be
  174. of importance if virtual memory is introduced.
  175.  
  176.  
  177. 1.42:
  178.  
  179. Added the FREEMEMRESULT option to set a result code for FreeMem(). This can
  180. be used to work around bugs of various programs, check the guide for
  181. details.
  182.  
  183. 1.41.3:
  184.  
  185. Added the RexxSerDevFix archive to the distribution. This patches a bug in
  186. the rexxserdev.library. Check the guide for details.
  187.  
  188. 1.41.2:
  189.  
  190. Fixed the description of the pgs_PatchMem program, added Carl's EMail.
  191.  
  192. 1.41.1:
  193.  
  194. Added the pgs_patchmem experimental program. Might help to avoid Photogenics
  195. crashes, but don't use it permanently. Read the guide first before trying it.
  196. Thanks goes to Carl Drougge for writing this program, and for allowing me to
  197. redistribute it.
  198. ______________________________________________________________________________
  199.  
  200. Have fun,
  201.     Thomas        November 1999
  202.